Get the total surplus earned by the user. [UNSTABLE]

GET

api

users

{address}

total_surplus

Get the total surplus earned by the user. [UNSTABLE]

curl --request GET \
  --url https://api.cow.fi/mainnet/api/v1/users/{address}/total_surplus

{
  "totalSurplus": "<string>"
}

address

string

required

20 byte Ethereum address encoded as a hex with 0x prefix.

Example:

"0x6810e776880c02933d47db1b9fc05908e5386b96"

The total surplus.

totalSurplus

string

The total surplus.

Last modified on March 17, 2026

⌘I

Get the total surplus earned by the user. [UNSTABLE]

curl --request GET \
  --url https://api.cow.fi/mainnet/api/v1/users/{address}/total_surplus

{
  "totalSurplus": "<string>"
}